home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 December / Chip_2001-12_cd1.bin / zkuste / delphi / kompon / d3456 / ACF10CE.ZIP / Read me.txt < prev    next >
Encoding:
Text File  |  2001-09-10  |  5.8 KB  |  147 lines
  1. TNyBck compenent V 1.3  10.9.2001
  2. Nihat Yorganci nyorganci@hotmail.com
  3.  Please send me notes, bugs and problems.
  4.  
  5.  
  6. Export and import whole database to the text files and binary files.
  7.  Memo and BLOB fields are also supported. TnyBck is saved Total record count in Text file when Export.
  8. so you can use this count as Gauge Max Value.Please examine to Demo.
  9.  
  10.  
  11. if you have calculated fields or lookupfields in dataset you must not be export this fields. See Csvmap properties.
  12.  
  13.  You can use this component for free in commercial or non-commercial programs
  14.  Please send me the changes you made in source code, and do not forgret my credit!
  15.  
  16.  
  17. This compenent TPgCSV (Khashayar Sadjadi (khashi@pragena.8m.com)) And KDatabase Export pack(delphi@korzh.com) Combined.
  18.  
  19.  
  20.  
  21. Installation:
  22.  
  23.  Remove Nybck component previous version.Click Component menu. Select Install Component.
  24. Select Nybck.pas in Unit File Name with Browse.
  25. Select Package file name exist your computer(*.dpk).
  26. or Select into new package, write a new filename in Package file name.Press ok.
  27. Appear package box and press install. After Save *.dpk file.
  28.  
  29.  
  30.  
  31. Usage
  32.  1. Place the component of your Form or DataModule.
  33.  2. Set the proprties (See properties section in this readme)
  34.  3. Close dataset
  35.  4. Call Imprt or Exprt methods.
  36.  5. Open Dataset
  37.  
  38. see Test.dpr.
  39.  
  40.  
  41. Properties:
  42.  
  43. CSVMap : Mapping of BCK file(text file) and table fields. A List of field names, started bt value of
  44.       FieldIndicator value and seprated by Seprator value.
  45.           Ex: $Name,$Age,$BirthDate
  46.            if you writed CSVMap and Export all records, please don't change
  47.            CSVMap string while import all records to dataset. Othervise raised errors.
  48.            only exported and imported fields in CsvMap string. So you don't have to Export
  49.            calculated and lookup fields.
  50.  
  51.  
  52. Dataset :Tdataset. TDataset in Delphi forms or DataModules to link with TNyBck for Import and Export.
  53.  
  54. Delimiter: Char. Seprator character.specifies the delimiter that will separate field values in
  55.            the text files.Default '"' .
  56.  
  57. FieldIndicator  : Special character for identifing field names in CSVMap.
  58.  
  59. Seprator    : Seprator character. Offten ,
  60.  
  61. SilentImport    :boolean. Setting this property to True forces TNyBck to do not raise exceptions and call ImportError event
  62.  
  63.  
  64. TextFile :String. A Text file. Each record in a seperate line, seperated by CR.
  65.           if your have blob or memo field TnyBck create a binary file (*.mem).
  66.          example: textfile:= 'myfile.Bck', TnyBck also create myfile.mem.
  67.  
  68.  
  69. TotalRecord :integer.Read only. Get Totol record  in BeforeExport and Before▌mport events.You get Total Record only this two events.
  70.              You can use Totol Record your gauge max value.
  71. Events:
  72.  
  73. AfterCloseTable  : Fires after TNyBck closed dataset.
  74.  
  75. AfterExport      : Fires after export process of a dataset to a Text Files( and *.Mem files) finishes.
  76.  
  77. AfterImport     : Fires after import process of a Text files (and *.mem) to dataset finishes.
  78.  
  79. AfterOpenTable   : Fires after TNyBck opens the dataset.
  80.  
  81. BeforeCloseTable : Fires before TNyBck closes the database.
  82.  
  83. BeforeExport     : Fires before export process starts from a Dataset to a Text files.
  84.  
  85. BeforeImport     : Fires before import process starts from a Text files to a Dataset.
  86.  
  87. BeforeOpenTable  : Fires before TNyBck opens dataset.
  88.  
  89. ImportError     : Firest each time an exception occures in Importing a Text to a dataset.
  90.            You can force TNyBck to handle ignore error or abort the process.
  91.            This event will be fired only if Silent²mport property is setted to True.
  92.  
  93. ExportProgress     : Fires each time a new record added to a Text files during exportin a dataset to a textFiles.
  94.            You can Stop export progress by setting StopIt parameter to True.
  95.  
  96. ImportProgress     : Fires each time a new record added to a dataset during importing a text fileto a dataset.
  97.            You can Stop import progress by setting StopIt parameter to True.
  98.  
  99. OnAddRecord     : Fires each time a new record added to dataset during importing a Text to a dataset.
  100. Exception handling:
  101.  
  102. By setting SilentImport property to True, if an exception occure in Import method, TNyBck will
  103. not raise exception and will call ImportError event with exception message and record number.
  104. You can set the Response parameter to nybckIgnore or nybckAbort to make TnyBck handle the exception.
  105. Setting Response to nybckIgnore will make TNyBck ignore current record and it will continue Importing, but
  106. nybckAbort will terminate import process at the currect record.
  107. Default value of Response parameter is nybckIgnore.
  108.  
  109. Progress monitoring:
  110.  
  111. By writing event handlers for ExportProgress and ImportProgress events, you can monitor Import and/or
  112. Export progress during the process. You can also stop process by setting StopIt parameter to True within
  113. event handler.
  114.  
  115. Total Record: Readonly.Total record write in text file first line(Export method).
  116.               Total Record Reading in text file first line(Import mehthod).
  117. You can get Total record in BeforeExport and BeforeImport events.
  118.  
  119. AutoMapping feature:
  120. ----------------------------------------------
  121. If you leave the CSVMap property blank, TPgCSV will use all Dataset
  122.  fields to generate *.Bck file in Exprt and ▌mprt method.
  123.  
  124.  
  125.  
  126. History:
  127.  
  128. ver 1.3. (10.9.2001)
  129. a major bug solved in imprt method.
  130.  
  131.  
  132. ver 1.2. (8.9.2001)
  133. Export Method change Exprt, ▌mport Method change imprt.
  134. CsvMap, fieldindicator and Seprator properties added.
  135.  
  136. ver 1.1   (26.1.2001)
  137. Some bugs solved.
  138.  
  139. Test Demo Project note:
  140. please compile this project And Open windows
  141. explorer and Click test.exe.
  142. Because ▌f you run with Delphi and import record when Key violation
  143. Error raised.
  144. Firs time you do click export,after delete 2 or 3 record and click
  145. import.
  146. You can see Don't raise "key violation" error.
  147.